home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / cfsadmin.z / cfsadmin
Encoding:
Text File  |  2002-10-03  |  11.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ccccffffssssaaaaddddmmmmiiiinnnn((((1111MMMM))))                                                      ccccffffssssaaaaddddmmmmiiiinnnn((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cfsadmin - administer disk space used for caching file systems with the
  10.      Cache File-System (CacheFS)
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ccccffffssssaaaaddddmmmmiiiinnnn ----cccc [ ----oooo _c_a_c_h_e_F_S-_p_a_r_a_m_e_t_e_r_s ] _c_a_c_h_e__d_i_r_e_c_t_o_r_y
  14.      ccccffffssssaaaaddddmmmmiiiinnnn ----dddd [ _c_a_c_h_e__I_D| aaaallllllll ] _c_a_c_h_e__d_i_r_e_c_t_o_r_y
  15.      ccccffffssssaaaaddddmmmmiiiinnnn ----llll _c_a_c_h_e__d_i_r_e_c_t_o_r_y
  16.      ccccffffssssaaaaddddmmmmiiiinnnn ----uuuu [ ----oooo _c_a_c_h_e_F_S-_p_a_r_a_m_e_t_e_r_s ] _c_a_c_h_e__d_i_r_e_c_t_o_r_y
  17.      ccccffffssssaaaaddddmmmmiiiinnnn ----CCCC _c_a_c_h_e__d_i_r_e_c_t_o_r_y
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The ccccffffssssaaaaddddmmmmiiiinnnn command provides administrative tools for managing cached
  21.      file systems.  Its functions fall into four general categories:
  22.  
  23.           +o cache creation
  24.  
  25.           +o deletion of cached file systems
  26.  
  27.           +o listing of cache contents and statistics
  28.  
  29.           +o resource parameter adjustment when the file system is unmounted.
  30.  
  31.      For each form of the command, you must specify a cache directory, that
  32.      is, the directory under which the cache is actually stored. A path name
  33.      in the front file system identifies the cache directory.
  34.  
  35.      You can specify a cache ID when you mount a file system with CacheFS, or
  36.      you can let the system generate one for you. The ----llll option includes the
  37.      cache ID in its listing of information.  You must know the cache ID to
  38.      delete a cached file system.
  39.  
  40. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  41.      ----cccc             Create a cache under the directory specified by
  42.                     _c_a_c_h_e__d_i_r_e_c_t_o_r_y.  This directory must not exist prior to
  43.                     cache creation.
  44.  
  45.      ----dddd             Remove the file system whose cache ID you specify and
  46.                     release its resources, or remove all file systems in the
  47.                     cache by specifying aaaallllllll.  It is not necessary that a cache
  48.                     be removed by using ccccffffssssaaaaddddmmmmiiiinnnn.  The cache can simply be
  49.                     removed by using rrrrmmmm(1).
  50.  
  51.      ----llll             List file systems stored in the specified cache, as well
  52.                     as statistics about them. Each cached file system is
  53.                     listed by cache ID. The statistics document cache resource
  54.                     parameters.  The block allocation limits are given as
  55.                     percentages and in 512-byte block units.  Cache
  56.                     utilization may be accurately reported with dddduuuu(1M).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccffffssssaaaaddddmmmmiiiinnnn((((1111MMMM))))                                                      ccccffffssssaaaaddddmmmmiiiinnnn((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      ----uuuu             Update resource parameters of the specified cache
  75.                     directory.  Parameter values can only be increased.  To
  76.                     decrease the values, you must remove the cache and
  77.                     recreate it.  All file systems in the cache directory must
  78.                     be unmounted when you use this option. Changes will take
  79.                     effect the next time you mount any file system in the
  80.                     specified cache directory.  The ----uuuu option with no ----oooo
  81.                     option sets all parameters to their default values.
  82.  
  83.      ----CCCC             Convert an existing cache to the new format.  This
  84.                     consists of converting the cache IDs from their old form
  85.                     to the new form.
  86.  
  87.    CCCCaaaacccchhhheeeeFFFFSSSS RRRReeeessssoooouuuurrrrcccceeee PPPPaaaarrrraaaammmmeeeetttteeeerrrrssss
  88.      You can specify the following cacheFS resource parameters as arguments to
  89.      the ----oooo option. Separate multiple parameters with commas.
  90.  
  91.      mmmmaaaaxxxxbbbblllloooocccckkkkssss====_n    Maximum amount of storage space that CacheFS can use,
  92.                     expressed as a percentage of the total number of blocks in
  93.                     the front file system.  If CacheFS does not have exclusive
  94.                     use of the front file system, there is no guarantee that
  95.                     all the space the mmmmaaaaxxxxbbbblllloooocccckkkkssss parameter allows will be
  96.                     available. The default is 99990000.
  97.                     This value defines an upper bound on the space available
  98.                     to cachefs.  Once the utilization of the front file system
  99.                     (cachefs and non-cachefs) reaches this value, cachefs will
  100.                     no longer allocate space for the caching of files.
  101.  
  102.      hhhhiiiibbbblllloooocccckkkkssss====_n     This sets the high water mark for disk space usage.  The
  103.                     value _n is expressed as a percentage of the total number
  104.                     of blocks in the front front file system.  When the
  105.                     utilization of the front file system as a whole (cachefs
  106.                     and non-cachefs) reaches the high water mark, cachefs will
  107.                     begin removing cached files.  Enough files will be removed
  108.                     to bring the front file system usage down to the low water
  109.                     mark.  The default high water mark is 88885555.
  110.  
  111.      lllloooowwwwbbbblllloooocccckkkkssss====_n    This sets the low water mark for disk space usage.  The
  112.                     value _n is expressed as a percentage of the total number
  113.                     of blocks in the front front file system.  This value is
  114.                     used for cache replacement as described above for
  115.                     hhhhiiiibbbblllloooocccckkkkssss.  The default low water mark is 77775555.
  116.  
  117.      mmmmaaaaxxxxffffiiiilllleeeessss====_n     Maximum number of files that CacheFS can use, expressed as
  118.                     a percentage of the total number of inodes in the front
  119.                     file system.  If CacheFS does not have exclusive use of
  120.                     the front file system, there is no guarantee that all the
  121.                     inodes the mmmmaaaaxxxxffffiiiilllleeeessss parameter allows will be available.
  122.                     The default is 99990000.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ccccffffssssaaaaddddmmmmiiiinnnn((((1111MMMM))))                                                      ccccffffssssaaaaddddmmmmiiiinnnn((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      hhhhiiiiffffiiiilllleeeessss====_n      This sets the high water mark for file allocation.  The
  141.                     value _n is expressed as a percentage of the total number
  142.                     of blocks in the front front file system.  When the high
  143.                     water mark is reached, cachefs will begin removing cached
  144.                     files.  Enough files will be removed to bring the front
  145.                     file system usage down to the low water mark.  The default
  146.                     high water mark is 88885555.
  147.  
  148.      lllloooowwwwffffiiiilllleeeessss====_n     This sets the low water mark for file allocation.  The
  149.                     value _n is expressed as a percentage of the total number
  150.                     of blocks in the front front file system.  This value is
  151.                     used for cache replacement as described above for hhhhiiiiffffiiiilllleeeessss.
  152.                     The default low water mark is 77775555.
  153.  
  154.      The cache parameters may only be changed for unmounted caches.  The
  155.      values, however, may be adjusted in any direction.
  156.  
  157. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  158.      The following example creates a cache directory named ////ccccaaaacccchhhheeee:
  159.           eeeexxxxaaaammmmpppplllleeee%%%% ccccffffssssaaaaddddmmmmiiiinnnn ----cccc ////ccccaaaacccchhhheeee
  160.  
  161.      The following example creates a cache named ////ccccaaaacccchhhheeee1111 that can claim a
  162.      maximum of 60 percent of the blocks in the front file system, can use 50
  163.      percent of the front file system blocks without interference by CacheFS
  164.      internal control mechanisms (i.e., replacement).  Once this allocation
  165.      level has been reached, cachefs will remove cached files until the low
  166.      water value of 40 percent is reached.
  167.  
  168.           eeeexxxxaaaammmmpppplllleeee%%%% ccccffffssssaaaaddddmmmmiiiinnnn ----cccc ----oooo mmmmaaaaxxxxbbbblllloooocccckkkkssss====66660000,,,,lllloooowwwwbbbblllloooocccckkkkssss====44440000,,,,
  169.                hhhhiiiibbbblllloooocccckkkkssss====55550000 ////ccccaaaacccchhhheeee1111
  170.  
  171.      The following example lists the contents of a cache directory named
  172.      ////ccccaaaacccchhhheeee3333 and provides statistics about resource utilization:
  173.  
  174.           eeeexxxxaaaammmmpppplllleeee%%%% ccccffffssssaaaaddddmmmmiiiinnnn ----llll ////ccccaaaacccchhhheeee3333
  175.  
  176.      The following example removes the cached file system with cache ID 22223333
  177.      from the cache directory ////ccccaaaacccchhhheeee3333 and frees its resources (the cache ID is
  178.      part of the information returned by ccccffffssssaaaaddddmmmmiiiinnnn ----llll):
  179.  
  180.           eeeexxxxaaaammmmpppplllleeee%%%% ccccffffssssaaaaddddmmmmiiiinnnn ----dddd 22223333 ////ccccaaaacccchhhheeee3333
  181.  
  182.      The following example removes all cached file systems from the cache
  183.      directory ////ccccaaaacccchhhheeee3333:
  184.  
  185.           eeeexxxxaaaammmmpppplllleeee%%%% ccccffffssssaaaaddddmmmmiiiinnnn ----dddd aaaallllllll ////ccccaaaacccchhhheeee3333
  186.  
  187. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  188.      mmmmoooouuuunnnntttt(1M), ffffssssttttaaaabbbb(4), rrrrmmmm(4), dddduuuu(1M)
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.